home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / aros / readme.porting < prev   
Text File  |  1996-09-12  |  2KB  |  53 lines
  1.  
  2. WHAT IS THIS FILE
  3. -----------------
  4.  
  5. This file describes how to port AROS to a new kind of hardware.
  6.  
  7. HOW TO DO IT
  8. ------------
  9.  
  10. 1. Select an identifying name for your CPU (eg. i386, m68k, hppa, sparc)
  11.     and add "-emul" (eg. i386-emul) if your port is to be running as
  12.     a "sub-OS" or "-native" (eg. m68k-native) if the port will be a
  13.     standalone OS.
  14.  
  15. 2. Select an identifying name for your system (eg. sgi, linux, amiga, etc).
  16.  
  17. 3. Edit "configure" and make it recognize your kind of hardware and adjust
  18.     the numerous variables as your system requires.
  19.  
  20.     KERNEL - The kind of CPU you use (see 1.)
  21.     ARCH - Name of your system (see 2.)
  22.     SYS_CC - The name of your C compiler
  23.     COMMON_CFLAGS - options which should be handed to every call to the
  24.         C compiler (eg. -g -Wall -O0 etc.)
  25.     ILDFLAGS - The flags you must give to the compiler when linking to
  26.         prevent it to use any standard libraries or startup modules
  27.         (for GCC the options are -nostartfiles -nostdlib -Xlinker -i).
  28.         This is used to create AROS executables. These executables must
  29.         not have any unresolved symbols and all references must be
  30.         filled.
  31.     RANLIB - contains the name of your ranlib program. If you don't have
  32.         one, specify "true" here (or the name of any other shell command
  33.         which simply ignores all parameters and doesn't return an
  34.         error code).
  35.  
  36. 3. Make a copy of i386-emul to $(KERNEL) and convert all assembler sources
  37.     from x86 to your CPU.
  38.  
  39. 4. Type make. If there any errors, write them down, then fix them and
  40.     continue with step 4.
  41.  
  42. 5. Go to bin/$(ARCH)/AROS and start "arosshell". Now you can type
  43.     some commands (eg. "dir all", "list" or "demowin"). If all works well,
  44.     you get a list of directories and files with "dir all" and "demowin"
  45.     opens a window with some gadgets and renderings with which you can
  46.     play. Typing "Esc" or clicking on "Exit" quits the demo. To stop the
  47.     arosshell, you must press ^C (Ctrl-C) since as a real OS there is
  48.     no way to stop nicely.
  49.  
  50. 6. If you had any problems, send me a list so future versions of AROS can
  51.     fix them.
  52.  
  53.